Description

This PR adds a lightweight, dependency-free tool to convert UI5-style api.json files into browsable HTML documentation.

Problem Statement

Users commonly ask:

• How to use the api.json files generated by ui5 build jsdoc
• How to generate HTML documentation for internal hosting
• Whether there are plans to add HTML output to the build jsdoc task

Solution

Added a converter tool (tools/convert-apijson-to-html.cjs) that:

• Converts api.json → standalone HTML with zero dependencies
• Provides a convenient npm script: npm run apijson-to-html
• Generates self-contained, browsable documentation
• Works offline and is easy to integrate into CI/CD pipelines

Files Added

• tools/convert-apijson-to-html.cjs - Main converter script (115 lines)
• tools/README.md - Detailed tool documentation with usage examples
• docs/API_DOCUMENTATION.md - Comprehensive guide covering all api.json workflows
• package.json - Added apijson-to-html npm script

Key Features

• ✅ Zero external dependencies
• ✅ Follows all project code conventions (tabs, double quotes, ESLint style)
• ✅ Self-contained HTML output with TOC, properties, methods, examples
• ✅ Works with UI5 builder's api.json format
• ✅ Tested and working

Documentation

The new docs/API_DOCUMENTATION.md provides:

• Clear explanation of api.json vs. JSDoc HTML outputs
• Three approaches for HTML generation
• Integration workflows for internal documentation
• Examples and best practices

Testing

• ✅ Script syntax validated
• ✅ End-to-end tested with sample api.json
• ✅ No VSCode errors
• ✅ package.json valid

Related

This addresses a common community question about using the output from ui5 build jsdoc and provides a practical solution without requiring the full UI5 SDK infrastructure.